home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / Xext / XdbeGetVisualInfo.z / XdbeGetVisualInfo
Encoding:
Text File  |  1998-10-30  |  5.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXddddbbbbeeeeGGGGeeeettttVVVViiiissssuuuuaaaallllIIIInnnnffffoooo((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))XXXXddddbbbbeeeeGGGGeeeettttVVVViiiissssuuuuaaaallllIIIInnnnffffoooo((((3333XXXX11111111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XdbeGetVisualInfo
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           #include <X11/extensions/Xdbe.h>
  13.  
  14.           XdbeScreenVisualInfo *XdbeGetVisualInfo(
  15.               Display  *dpy,
  16.               Drawable *screen_specifiers,
  17.               int      *num_screens)
  18.  
  19.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.           This function returns information about which visuals
  21.           support double buffering.  The argument _n_u_m__s_c_r_e_e_n_s
  22.           specifies how many elements there are in the
  23.           _s_c_r_e_e_n__s_p_e_c_i_f_i_e_r_s list.  Each drawable in _s_c_r_e_e_n__s_p_e_c_i_f_i_e_r_s
  24.           designates a screen for which the supported visuals are
  25.           being requested.  If _n_u_m__s_c_r_e_e_n_s is zero, information for
  26.           all screens is requested.  In this case, upon return from
  27.           this function, _n_u_m__s_c_r_e_e_n_s will be set to the number of
  28.           screens that were found.  If an error occurs, this function
  29.           returns NULL, else it returns a pointer to a list of
  30.           _X_d_b_e_S_c_r_e_e_n_V_i_s_u_a_l_I_n_f_o structures of length _n_u_m__s_c_r_e_e_n_s. The
  31.           nth element in the returned list corresponds to the nth
  32.           drawable in the _s_c_r_e_e_n__s_p_e_c_i_f_i_e_r_s list, unless _n_u_m__s_c_r_e_e_n_s
  33.           was passed in with the value zero, in which case the nth
  34.           element in the returned list corresponds to the nth screen
  35.           of the server, starting with screen zero.  The
  36.           _X_d_b_e_S_c_r_e_e_n_V_i_s_u_a_l_I_n_f_o structure has the following fields:
  37.  
  38.                int            count
  39.                XdbeVisualInfo *visinfo
  40.  
  41.           _c_o_u_n_t specifies the number of items in _v_i_s_i_n_f_o. _v_i_s_i_n_f_o
  42.           specifies a list of visuals, depths, and performance hints
  43.           for this screen.
  44.  
  45.           The _X_d_b_e_V_i_s_u_a_l_I_n_f_o structure has the following fields:
  46.  
  47.                VisualID visual
  48.                int      depth
  49.                int      perflevel
  50.  
  51.           _v_i_s_u_a_l specifies one visual ID that supports double-
  52.           buffering.  _d_e_p_t_h specifies the depth of the visual.
  53.           _p_e_r_f_l_e_v_e_l is a performance hint.
  54.  
  55.           The only operation defined on a _p_e_r_f_l_e_v_e_l is comparison to a
  56.           _p_e_r_f_l_e_v_e_l of another visual on the same screen.  The visual
  57.           having the higher _p_e_r_f_l_e_v_e_l is likely to have better
  58.           double-buffering graphics performance than the visual having
  59.           the lower _p_e_r_f_l_e_v_e_l. Nothing can be deduced from the
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXddddbbbbeeeeGGGGeeeettttVVVViiiissssuuuuaaaallllIIIInnnnffffoooo((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))XXXXddddbbbbeeeeGGGGeeeettttVVVViiiissssuuuuaaaallllIIIInnnnffffoooo((((3333XXXX11111111))))
  71.  
  72.  
  73.  
  74.           following: the magnitude of the difference of two
  75.           _p_e_r_f_l_e_v_e_l_s, a _p_e_r_f_l_e_v_e_l value in isolation, or comparing
  76.           _p_e_r_f_l_e_v_e_l_s from different servers.
  77.  
  78.  
  79.      EEEERRRRRRRROOOORRRRSSSS
  80.           BadDrawable
  81.                One or more values passed in _s_c_r_e_e_n__s_p_e_c_i_f_i_e_r_s is not a
  82.                valid drawable.
  83.  
  84.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  85.           DBE, _X_d_b_e_A_l_l_o_c_a_t_e_B_a_c_k_B_u_f_f_e_r_N_a_m_e(), _X_d_b_e_B_e_g_i_n_I_d_i_o_m(),
  86.           _X_d_b_e_D_e_a_l_l_o_c_a_t_e_B_a_c_k_B_u_f_f_e_r_N_a_m_e(), _X_d_b_e_E_n_d_I_d_i_o_m(),
  87.           _X_d_b_e_F_r_e_e_V_i_s_u_a_l_I_n_f_o(), _X_d_b_e_G_e_t_B_a_c_k_B_u_f_f_e_r_A_t_t_r_i_b_u_t_e_s(),
  88.           _X_d_b_e_Q_u_e_r_y_E_x_t_e_n_s_i_o_n(), _X_d_b_e_S_w_a_p_B_u_f_f_e_r_s().
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.